home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 April / Software of the Month Club 1996 April.iso / pc / utility / os2 / robosv / robosave.doc < prev    next >
Text File  |  1996-02-21  |  40KB  |  855 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.      ROBOSAVE Version 3.04
  11.  
  12.  
  13.      A Utility for Saving the OS/2 2.X Desktop
  14.  
  15.      User's Guide
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.      R. R. Kurtz
  31.  
  32.      J. G. Knauth
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.      (c) Copyright International Business Machines Corporation 1994.
  41.      All rights Reserved.
  42.  
  43.  
  44.      9 Nov 1993  3:04  --  Employee Written Software Edition
  45.      9 Nov 1993  3:04  --  Employee Written Software Edition
  46.  
  47.  
  48.      CONTENTS
  49.  
  50.  
  51.      1.0  ROBOSAVE User's Guide   . . . . . . . . . . . . . . . . . . .   1
  52.      1.1  What ROBOSAVE Does  . . . . . . . . . . . . . . . . . . . . .   1
  53.      1.2  Overview  . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  54.      1.3  What ROBOSAVE Does Not Do   . . . . . . . . . . . . . . . . .   2
  55.      1.4  Prerequisites   . . . . . . . . . . . . . . . . . . . . . . .   3
  56.      1.5  Installation  . . . . . . . . . . . . . . . . . . . . . . . .   3
  57.      1.6  ROBOSAVE Profile  . . . . . . . . . . . . . . . . . . . . . .   3
  58.      1.7  ROBOSAVE Command  . . . . . . . . . . . . . . . . . . . . . .   6
  59.      1.8  Doing a Save  . . . . . . . . . . . . . . . . . . . . . . . .   6
  60.      1.9  Doing a Restore   . . . . . . . . . . . . . . . . . . . . . .   8
  61.      1.10  Recovery of Individual Files   . . . . . . . . . . . . . . .  10
  62.      1.11  Choosing a Save Directory  . . . . . . . . . . . . . . . . .  11
  63.      1.12  Contents of the Save Directory   . . . . . . . . . . . . . .  12
  64.      1.13  ROBOSVUT Utility   . . . . . . . . . . . . . . . . . . . . .  13
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.                                                                Contents  ii
  99.      9 Nov 1993  3:04  --  Employee Written Software Edition
  100.  
  101.  
  102.      1.0  ROBOSAVE USER'S GUIDE
  103.  
  104.  
  105.      This edition of the User's Guide is for the Employee Written Software
  106.      release of ROBOSAVE.
  107.  
  108.  
  109.      1.1  WHAT ROBOSAVE DOES
  110.  
  111.      ROBOSAVE is a tool which allows you to quickly and easily back up the
  112.      OS/2 2.x Desktop.  In addition you can save a limited number of user-
  113.      specified files.  If problems occur later, you can easily restore the
  114.      saved information.  Because it is so easy to do a ROBOSAVE, you will
  115.      find that doing frequent backups is quite painless.
  116.  
  117.      The OS/2 2.x Desktop consists of control information for such things
  118.      as folders, program objects, printer objects, and shadows.  It also
  119.      contains data about the tailoring you have done for colors, fonts,
  120.      titles, window positions, associations, and much more.  You may have
  121.      invested a significant amount of time in adjusting the Desktop to your
  122.      preferences.  ROBOSAVE provides a good way to protect that investment.
  123.  
  124.  
  125.      1.2  OVERVIEW
  126.  
  127.      Using ROBOSAVE is very simple.  Here is a summary.  Details are in
  128.      following sections, together with suggestions for how you might plan
  129.      ROBOSAVE backups for your system.
  130.  
  131.      -   Installation
  132.  
  133.          -   Download and unzip ROBOSAVE's zip file into a directory of
  134.              your choice
  135.          -   Set up a ROBOSAVE profile; you can use ROBOSAVE.SMP as a model
  136.  
  137.      -   Doing a save
  138.  
  139.          -   Stabilize the Desktop by doing a shutdown and IPL
  140.          -   Invoke ROBOSAVE, using the profile you created above
  141.  
  142.      -   Doing a restore
  143.  
  144.          -   Bring up an OS/2 environment suitable for doing ROBOREST
  145.          -   Switch to the save drive and directory
  146.          -   Invoke ROBOREST
  147.          -   ReIPL
  148.  
  149.  
  150.  
  151.  
  152.                                                    ROBOSAVE User's Guide  1
  153.      9 Nov 1993  3:04  --  Employee Written Software Edition
  154.  
  155.  
  156.      1.3  WHAT ROBOSAVE DOES NOT DO
  157.  
  158.      ROBOSAVE does not do a full backup of all the data on your system.
  159.      Instead it saves only certain key information.  Part of this informa-
  160.      tion is saved automatically.  Part you must specify thru a profile.  A
  161.      sample ROBOSAVE profile is provided; however, there may be other crit-
  162.      ical files for your applications that you should specify in your own
  163.      profile.  Restoring this information is often sufficient to get your
  164.      system working again very quickly.  Of course doing a full backup pro-
  165.      vides a better guarantee of a full recovery.  However, doing a full
  166.      backup requires much more time and more space on your backup medium.
  167.  
  168.      From ROBOSAVE's point of view the Desktop consists of the Desktop
  169.      directory and all the files and directories under it.  This is the
  170.      information ROBOSAVE will save automatically.  You must be careful
  171.      about what information you either remove from or add to that directory
  172.      tree.
  173.  
  174.      If you move an object from the Desktop to some location that is not in
  175.      the Desktop, ROBOSAVE will NOT save that object.  For example, suppose
  176.      your Desktop directory is C:\DESKTOP.  The standard OS/2 install will
  177.      create a Productivity folder in the OS/2 System folder.  Suppose you
  178.      use the Workplace Shell Drives facility to drag the Productivity
  179.      folder to some location not in the Desktop, let's say into a C:\MISC
  180.      directory.  From a (FAT) file system point of view, you just moved the
  181.      C:\DESKTOP\OS!2_SYS\PRODUCTI directory to C:\MISC\PRODUCTI.  It is no
  182.      longer under C:\DESKTOP and will not be automatically saved by
  183.      ROBOSAVE.  Even if you create a shadow on the Desktop of the moved
  184.      Productivity folder, the moved folder will not be saved because it is
  185.      no longer in the Desktop.  However, if all you do is move the object
  186.      to another place in the Desktop, e.g., suppose you move it from the
  187.      OS/2 System folder to the Information folder (assuming this folder
  188.      itself is still in the Desktop), then the object is still in the
  189.      Desktop structure and will be automatically saved by ROBOSAVE.
  190.  
  191.      This works both ways.  If you create directories or files in the
  192.      Desktop directory tree, ROBOSAVE will consider all that information as
  193.      part of the Desktop and will save it automatically.  Thus you should
  194.      be careful not to put a bunch of "extraneous" things in the Desktop
  195.      unless you really do want all that information saved every time you do
  196.      a ROBOSAVE.
  197.  
  198.      ROBOSAVE is not intended to migrate a Desktop from one release (or CSD
  199.      level) of OS/2 to another.  The control information that ROBOSAVE
  200.      saves from one release of OS/2 may very well not be compatible with
  201.      another OS/2 release.  Similarly, if after you do a ROBOSAVE you then
  202.      change any fundamental system characteristics (e.g., file system type,
  203.      display type, or boot drive), restoring the old system's data to the
  204.  
  205.  
  206.                                                    ROBOSAVE User's Guide  2
  207.      9 Nov 1993  3:04  --  Employee Written Software Edition
  208.  
  209.  
  210.      new system will not work.  ROBOSAVE is intended to backup a system and
  211.      then restore the data to exactly that same system.
  212.  
  213.      ROBOSAVE does not save the information used to automatically restart
  214.      currently running programs.  This is done to prevent restarting
  215.      ROBOSAVE itself when the restored system is first IPLed.  The impli-
  216.      cation of this is that after your system has been restored, you must
  217.      restart your normally running programs yourself for the initial IPL.
  218.      For subsequent IPLs, those programs will be restarted (or not) as
  219.      usual, depending on the way you have chosen to tailor OS/2 for this
  220.      restart function.
  221.  
  222.  
  223.      1.4  PREREQUISITES
  224.  
  225.      Your operating system must be either OS/2 2.0 or 2.1.  ROBOSAVE does
  226.      not support earlier releases, e.g., OS/2 1.3.
  227.  
  228.      REXX is required in order to use ROBOSAVE.  REXX is installed in OS/2
  229.      by default.  You can use OS/2 Selective Install to add REXX if it is
  230.      not already present on your system.
  231.  
  232.  
  233.      1.5  INSTALLATION
  234.  
  235.      Download ROBOSAVE's zip file in binary and unzip it into a directory
  236.      of your choice.  Either this directory must be in your PATH, or it
  237.      should be the current directory when ROBOSAVE is invoked.
  238.  
  239.  
  240.      1.6  ROBOSAVE PROFILE
  241.  
  242.      A profile is required to run ROBOSAVE.  See ROBOSAVE.SMP for an
  243.      example.  The profile is an ASCII text file which specifies parameters
  244.      for operating ROBOSAVE.  Usually you will name your profile
  245.      ROBOSAVE.PRO, although you can give it a different name and then
  246.      specify that name in the ROBOSAVE command.
  247.  
  248.      The profile controls what files will be saved.  If you don't specify
  249.      the right files for saving, they won't be available for restoring --
  250.      not good.  Please invest the time to set up your profile appropriately
  251.      to begin with, and keep it up to date as your application environment
  252.      changes.
  253.  
  254.      If an "*" is found in column 1 of a line in the profile, that line is
  255.      treated as a comment and is ignored.  You should not have any blank
  256.      lines in the profile; a blank line will terminate profile processing.
  257.      One of the following verbs must start each of the non-comment lines of
  258.  
  259.  
  260.                                                    ROBOSAVE User's Guide  3
  261.      9 Nov 1993  3:04  --  Employee Written Software Edition
  262.  
  263.  
  264.      the profile.  The verbs can be in any order and can be in upper or
  265.      lower case.
  266.  
  267.      SAVE=directory
  268.           where "directory" specifies the directory in which ROBOSAVE will
  269.           save the files to be backed up, together with certain control
  270.           information.  This directory will be created for you if it does
  271.           not exist.  This is a required verb; there is no default.
  272.           Examples: "save=A:\SAVEDATA" and "save=E:\SV930922".  Later
  273.           sections of the User's Guide provide guidance about choosing a
  274.           save directory and give details about what is put into it.
  275.  
  276.      SAVENUM=number
  277.           where "number" specifies the number of generations of data that
  278.           can be saved in this directory.  A new generation is created each
  279.           time you successfully complete ROBOSAVE.  When "number" is
  280.           exceeded, the oldest generation is erased and is replaced by the
  281.           new generation, the data saved by the current execution of
  282.           ROBOSAVE.  If you reduce "number", all the older generations are
  283.           erased up to the point where "number" will not be exceeded by the
  284.           new generation.  Valid values are 1 thru 9.  This is a required
  285.           verb; there is no default.
  286.  
  287.      CLEANUP=B|E
  288.           specifies when old generations should be erased if the "SAVENUM="
  289.           number is exceeded, as described above.  "CLEANUP=B" means erase
  290.           the data at the beginning of the ROBOSAVE operation, i.e., before
  291.           the new generation is created.  "CLEANUP=E" means erase the old
  292.           data at the end, i.e., after the new generation has been created.
  293.           The default is "CLEANUP=E".  Erasing at the end is safer, in that
  294.           the old data will not be erased unless the new generation has
  295.           been successfully saved.  However, erasing at the beginning might
  296.           be necessary if the save directory is on a drive with little
  297.           available space; you might need to erase the old generation first
  298.           to make room for the new generation.
  299.  
  300.      LOG=P|T
  301.           specifies the location of the ROBOSAVE.LOG file.  This log
  302.           records all ROBOSAVE activity for the save directory specified by
  303.           the "SAVE" verb.  "LOG=P" means put the log in the same directory
  304.           as the ROBOSAVE profile.  "LOG=T" means put the log in the save
  305.           directory.  The default is "LOG=P".
  306.  
  307.      ROBO=fileid [fileid ...]
  308.           where each "fileid" specifies one or more files to be saved in
  309.           the save directory.  Normally the complete fileid (drive, path,
  310.           and file) should be specified, e.g., robo=e:\somedir\myfile.xyz.
  311.           Multiple fileids can be specified on each ROBO= line.  Wildcards,
  312.  
  313.  
  314.                                                    ROBOSAVE User's Guide  4
  315.      9 Nov 1993  3:04  --  Employee Written Software Edition
  316.  
  317.  
  318.           both "*" and "?", can be used in the same way they are used in
  319.           the OS/2 COPY command.  If there are any blanks in the fileid,
  320.           enclose the entire fileid in double quotes.  In addition, by
  321.           enclosing the fileid in brackets, you indicate that directories
  322.           below the one specified in the fileid should also be searched.
  323.           Bracketed fileids can be intermixed with normal fileids on the
  324.           same line.  In the following examples, notice the use of double
  325.           quotes and brackets; the quotes must be outside the brackets when
  326.           both are used.
  327.  
  328.                    Profile line                        Files saved
  329.             --------------------------   ---------------------------------------
  330.             robo=d:\os2\*.ini            D:\OS2\OS2.INI, D:\OS2\OS2SYS.INI, etc.
  331.             robo="d:\my dir\my  data"    D:\MY DIR\MY  DATA
  332.             robo=[e:\*.ini]              All .INI files on the E: drive
  333.             robo=[g:\my*.*]              All files on the G: drive whose names
  334.                                            start with MY with any extension
  335.             robo="[g:\Down\U ar*.*]"     All files in the G:\DOWN directory (and
  336.                                            all its subdirectories) whose names
  337.                                            start with "U AR" and any extension
  338.             robo=c:\x.y  d:\dir\ccc.y    C:\X.Y and D:\DIR\CCC.Y
  339.  
  340.           Examine ROBOSAVE.SMP for a list of additional files you may want
  341.           to save if you installed OS/2 Windows support, Communications
  342.           Manager, or LAN Services.
  343.  
  344.           You should not attempt to save ". SF" files, e.g., "EA DATA. SF".
  345.  
  346.           WARNING: You should be careful with using wildcard characters
  347.           and/or brackets.  It is very easy to unintentionally specify many
  348.           files you don't really want to backup.  This is especially sig-
  349.           nificant if your save directory is on a diskette, which has less
  350.           space and operates more slowly than a hard disk.  It is also easy
  351.           to unintentionally save a file multiple times; ROBOSAVE will make
  352.           a separate copy for each specification, whether it was an
  353.           explicit specification or by wildcards or brackets.  Thus, speci-
  354.           fying both "robo=e:\abc.ini" and "robo=e:\*.ini" would copy
  355.           ABC.INI twice.  It is a good idea after doing a ROBOSAVE to
  356.           examine ROBOSAVE.LOG and see exactly which files were copied;
  357.           then adjust your profile if necessary.  Needless to say, having
  358.           something like "robo=c:\*.*" would attempt to save far more than
  359.           you really intended; in fact it would likely fail as the process
  360.           stumbled over certain files that cannot be copied normally.
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.                                                    ROBOSAVE User's Guide  5
  369.      9 Nov 1993  3:04  --  Employee Written Software Edition
  370.  
  371.  
  372.      1.7  ROBOSAVE COMMAND
  373.  
  374.      Here is the syntax of the ROBOSAVE command.  If the "/P" parameter is
  375.      used, it must be the last parameter specified.
  376.  
  377.        ROBOSAVE  [[fileid]...]  [/P=profile]
  378.  
  379.      fileid
  380.           has the same syntax and meaning as when used in a "ROBO=" line in
  381.           a ROBOSAVE profile.  Specifying a fileid as a ROBOSAVE command
  382.           parameter has the same effect as specifying it in the profile.
  383.           Fileids specified in the command are logically merged with those
  384.           from the "ROBO=" lines of the profile.  If no fileid parameter is
  385.           specified in the ROBOSAVE command, only the fileids from the
  386.           "ROBO=" lines will be used.
  387.  
  388.      /P=profile
  389.           specifies the profile used by ROBOSAVE.  This can be either a
  390.           complete fileid (drive, path, file) or it can be just the drive
  391.           and path; in the latter case the file is considered to be named
  392.           ROBOSAVE.PRO and it must reside in the drive-path directory.  If
  393.           this parameter is not specified, the first occurrence of
  394.           ROBOSAVE.PRO found in the current directory or PATH is used.
  395.  
  396.      Here are some examples:
  397.  
  398.        robosave
  399.        robosave  /p=d:\os2tools
  400.        robosave  e:\myapps\myapp.dat   g:\temp\some.stf
  401.        robosave  "e:\my dir\my file.dat"   "g:\main  dir\sub dir"
  402.        robosave  e:\os!2_apps\*.ini   /p=d:\my2tool\myprof.xyz
  403.        robosave  [e:\*.ini]   "[g:\Down\This\Road\one way.*]"
  404.  
  405.  
  406.      1.8  DOING A SAVE
  407.  
  408.      After you have installed ROBOSAVE and have built your profile, you can
  409.      invoke it to save your data.  In fact, this is the part of ROBOSAVE
  410.      you will be using most often; it is very easy to do.  Before doing the
  411.      save, however, you should ensure your Desktop has stabilized.  In par-
  412.      ticular, if you have made Desktop changes since you last IPLed,
  413.      including moving objects around on the Desktop, and you want to be
  414.      sure all this information is captured, you should shut down your
  415.      system cleanly and reIPL.  Then you can do the save.  This is neces-
  416.      sary because for some control information, OS/2 will not write the
  417.      data to disk (where it can be copied by ROBOSAVE) until shutdown is
  418.      done.  Other control information is written to disk only occasionally,
  419.      in a lazy-write fashion.  Doing a shutdown will force that information
  420.  
  421.  
  422.                                                    ROBOSAVE User's Guide  6
  423.      9 Nov 1993  3:04  --  Employee Written Software Edition
  424.  
  425.  
  426.      to disk, too.  Of course after you reIPL, don't start making more
  427.      Desktop changes before doing the ROBOSAVE.  It is preferable to have
  428.      as little as possible going on while ROBOSAVE is running to lessen the
  429.      chance that any data will be changing while it is being saved.  If
  430.      that happens, the saved data might be inconsistent and any subsequent
  431.      restore from it might not produce what you want.  ROBOSAVE runs
  432.      quickly.  Be patient and let it operate without interference.
  433.  
  434.      Now to do the save.  Normally you just enter "ROBOSAVE" at an OS/2
  435.      command prompt, either full screen or windowed.  If necessary, you can
  436.      specify ROBOSAVE command parameters, as described in the preceding
  437.      section.  However most people will specify all fileids via "ROBO="
  438.      lines in their profile and will put their profile in a directory in
  439.      their PATH; if you do this, no command parameters are necessary -- you
  440.      can just say "ROBOSAVE".
  441.  
  442.      If you want to be fancier about ROBOSAVE invocation, you can build an
  443.      OS/2 program object and then doubleclick on its icon to do a ROBOSAVE.
  444.      To build such an object, drag a program object from the Templates
  445.      folder.  Then fill in the blanks as follows:
  446.  
  447.      -   On the Program page:
  448.  
  449.          -   Set "Path and file name" to "x:\path\ROBOSAVE.CMD".  Replace
  450.              "x:\path" with the drive and directory where you put ROBOSAVE.
  451.          -   Set "Parameters" with whatever parameters you need (usually
  452.              leave this blank).
  453.          -   Set "Working directory" with ROBOSAVE's directory, i.e., with
  454.              your values for the "x:\path" mentioned in the first item.
  455.  
  456.      -   On the Session page:
  457.  
  458.          -   Uncheck "Close window on exit".  This is necessary to allow
  459.              you to see any error messages before the window is closed.
  460.              When you are finished with ROBOSAVE, just close the window as
  461.              you normally would, e.g., by doubleclicking on the system icon
  462.              in the upper left corner of the window.
  463.  
  464.      -   On the General page:
  465.  
  466.          -   Change "Title" to whatever you want to show up under the pro-
  467.              gram's icon.  If you have done all the preceding steps, the
  468.              icon shipped with ROBOSAVE should already be displayed.
  469.  
  470.      WARNING: Needless to say, if you wait to do a backup until AFTER you
  471.      have had a problem, then any restore with that backup data will just
  472.      put you right back in the problem state again.  Thus you need to do
  473.      backups BEFORE you have a problem.  Generally, you should do a backup
  474.  
  475.  
  476.                                                    ROBOSAVE User's Guide  7
  477.      9 Nov 1993  3:04  --  Employee Written Software Edition
  478.  
  479.  
  480.      after any major change if you are satisfied with the results of that
  481.      change.  This will give you a checkpoint of a system that you are now
  482.      satisfied with, but before you or some outside force messes it up.  Of
  483.      course this assumes you have been following this procedure all along
  484.      and thus already have a good backup of the system BEFORE making the
  485.      major change.  If you don't have such a BEFORE-the-change backup
  486.      already, then make one first.  Because ROBOSAVE is so easy to use and
  487.      takes only a few minutes at most, it is very easy to do all this.
  488.      Just be sure to label your backups so you'll know what you've got.  We
  489.      recommend doing major backups to diskettes (freshly formatted and
  490.      still empty) -- one backup per diskette.
  491.  
  492.  
  493.      1.9  DOING A RESTORE
  494.  
  495.      Suppose disaster has just struck.  Maybe you accidentally powered off
  496.      your system without doing a shutdown first, or possibly a power outage
  497.      occurred.  Both of these can result in a corrupted Desktop.  Or maybe
  498.      you got overenthusiatic while you were tidying up your Desktop and
  499.      dropped the wrong thing on the shredder.  Or maybe you encountered a
  500.      programming bug.  Or maybe your hardware hiccupped.  Or ... you get
  501.      the idea.  If you have been faithfully doing ROBOSAVEs and have been
  502.      saving the right data, you can probably recover your system completely
  503.      and quickly.  It is important to realize that the system will be
  504.      restored back to the point it was at when you did the ROBOSAVE for
  505.      that data.  If you made any changes after that ROBOSAVE, those changes
  506.      may be lost.  This points out the desirability of doing frequent
  507.      ROBOSAVEs and keeping your profile up to date.
  508.  
  509.      Part of the data created by ROBOSAVE in your save directory is a
  510.      ROBOREST.CMD.  Executing that command will restore the data saved by
  511.      the ROBOSAVE you issued most recently to that save directory.  If you
  512.      have saved multiple generations in the same save directory, there will
  513.      be a ROBOREST.CM1, a ROBOREST.CM2, etc.  These represent the next
  514.      older generation, and the next older beyond that, etc., with the
  515.      oldest having the highest .CMn number.  If you want to recover a pre-
  516.      vious generation instead of the most recent, just rename ROBOREST.CMD
  517.      to some other name, e.g., ROBOREST.CUR, and then rename the desired
  518.      ROBOREST.CMn to ROBOREST.CMD.  You can examine ROBOSAVE.LOG to see
  519.      when each save was done and what files were associated with each.  You
  520.      can doublecheck the chosen command file to ensure it is the desired
  521.      one.
  522.  
  523.      Before invoking ROBOREST, you must first set up the proper OS/2 envi-
  524.      ronment.  You cannot simply issue ROBOREST from an OS/2 command prompt
  525.      in your normal system since some of the files ROBOREST will try to
  526.      replace are in use by the normal system.  You must establish an envi-
  527.      ronment independent of your normal system and issue ROBOREST from
  528.  
  529.  
  530.                                                    ROBOSAVE User's Guide  8
  531.      9 Nov 1993  3:04  --  Employee Written Software Edition
  532.  
  533.  
  534.      there.  Fortunately that is easy to do.  Below are three different
  535.      techniques you can use.  They produce equivalent results.  Use the one
  536.      that is most convenient for you.
  537.  
  538.      ROBOREST will attempt to verify that you have established a proper
  539.      environment.  If it detects something is wrong, it will display an
  540.      error message and stop the procedure without making any changes to
  541.      your system.  Part of the recovery procedure involves erasing the old
  542.      (possibly corrupted) Desktop before restoring the saved Desktop.  You
  543.      will be prompted for final authorization before this is done.  If you
  544.      answer anything other than "YES", the ROBOREST procedure will stop and
  545.      no changes will be made to your system.
  546.  
  547.      You should make sure you don't have a directory in the Desktop tree as
  548.      the current directory for its drive.  For example, if C:\DESKTOP is
  549.      your OS/2 Desktop directory, make sure you haven't done a CHANGEDIR on
  550.      C: to \DESKTOP or to any of the directories under it.  Having any of
  551.      those directories as the current directory would interfere with the
  552.      deletion of the Desktop tree.  ROBOREST (ROBOSVUT) will fail if you
  553.      make this mistake and will issue an error message.  If this happens,
  554.      just do a "CD \" and reissue ROBOREST.
  555.  
  556.      Except for the OS2.INI and OS2SYS.INI files, ROBOREST will restore the
  557.      same Readonly, System, and Hidden attributes for each file that
  558.      existed when you saved the file with ROBOSAVE.
  559.  
  560.      Restoring the Desktop - Method 1
  561.  
  562.      This method requires you to have the Install and DISK 1 diskettes for
  563.      the version of OS/2 you booted when you did the save.  It is required
  564.      that the OS/2 level of the diskettes must match exactly the level of
  565.      the system being restored, including the CSD level.  (In fact you may
  566.      be able to get away with a different level sometimes, but other times
  567.      you can't.  Since failure can result in a corrupted system, we require
  568.      the levels to be the same.)  Instead of using the actual installation
  569.      diskettes, you might use something equivalent, e.g., a diskette you
  570.      have created with the BOOTOS2 tool (also known as BOOT2X); the
  571.      diskette must be at the correct OS/2 level, of course.  Or you might
  572.      boot from another partition (at the correct OS/2 level, of course).
  573.  
  574.        - Boot from the OS/2 2.x Install and DISK 1 diskettes.
  575.        - ESC to the OS/2 prompt when allowed.
  576.        - Place your "save" diskette in A: if restoring from diskette.
  577.        - Change to the "save" drive you will restore from.
  578.        - Change to the "save" directory containing ROBOREST.CMD.
  579.        - Invoke ROBOREST; there are no parameters.
  580.        - Respond YES when prompted to delete the Desktop.
  581.        - Re-boot when the restore is complete.
  582.  
  583.  
  584.                                                    ROBOSAVE User's Guide  9
  585.      9 Nov 1993  3:04  --  Employee Written Software Edition
  586.  
  587.  
  588.      Restoring the Desktop - Method 2
  589.  
  590.      This method requires that the SHFTRN package be installed on your
  591.      system.  It must be on your hard drive and your CONFIG.SYS must have
  592.      been edited to place the call to SHIFTRUN in it.  This method is
  593.      faster than Method 1 and does not require the two OS/2 installation
  594.      diskettes.
  595.  
  596.        - Get the SHFTRN package from the same place you got ROBOSAVE.
  597.        - Download and install it as directed.
  598.        - Re-boot.
  599.        - Press Left-Shift when the SHIFTRUN timer appears, then release it.
  600.        - Place your "save" diskette in A: if restoring from diskette.
  601.        - Change to the "save" drive you will restore from.
  602.        - Change to the "save" directory containing ROBOREST.CMD.
  603.        - Invoke ROBOREST; there are no parameters.
  604.        - Respond YES when prompted to delete the Desktop.
  605.        - Re-boot when the restore is complete.
  606.  
  607.      Restoring the Desktop - Method 3
  608.  
  609.      This method is similar to using SHFTRN, but does not require the
  610.      SHFTRN tool.  It is quick and straightforward.  The tradeoff is that
  611.      you must edit CONFIG.SYS before using ROBOREST.  You could make this
  612.      your standard CONFIG.SYS, but then you would need to do an EXIT at the
  613.      command prompt for every IPL.  SHFTRN doesn't require that.
  614.  
  615.        - Edit CONFIG.SYS to put this line at the end,
  616.          where "x:" is your boot drive:
  617.             CALL=x:\OS2\CMD.EXE /K
  618.        - IPL; eventually you will get a command prompt.
  619.        - Place your "save" diskette in A: if restoring from diskette.
  620.        - Change to the "save" drive you will restore from.
  621.        - Change to the "save" directory containing ROBOREST.CMD.
  622.        - Invoke ROBOREST; there are no parameters.
  623.        - Respond YES when prompted to delete the Desktop.
  624.        - Re-boot when the restore is complete.
  625.  
  626.  
  627.      1.10  RECOVERY OF INDIVIDUAL FILES
  628.  
  629.      ROBOSAVE can also be useful if you have lost one or a few of your
  630.      saved files instead of losing the whole Desktop.  For example, if you
  631.      have accidentally erased your CONFIG.SYS, you can look at ROBOSAVE.LOG
  632.      to see the name under which it was copied to your save directory.
  633.      Then just copy it back to your boot drive and rename it to CONFIG.SYS.
  634.  
  635.  
  636.  
  637.  
  638.                                                   ROBOSAVE User's Guide  10
  639.      9 Nov 1993  3:04  --  Employee Written Software Edition
  640.  
  641.  
  642.      1.11  CHOOSING A SAVE DIRECTORY
  643.  
  644.      There are some decisions you need to make when choosing a save direc-
  645.      tory.  You can place the directory either on a diskette or on a hard
  646.      drive.  Placing the data on a diskette isolates it from the system and
  647.      gives you some additional reliability.  For example, if the system
  648.      hard drive itself fails, you can reinstall OS/2 and your applications
  649.      on a repaired drive and then use ROBOSAVE to reapply all your tai-
  650.      loring.
  651.  
  652.      You can easily and inexpensively keep multiple generations of backups
  653.      on separate diskettes with one generation per diskette.  Then just
  654.      rotate thru the set of diskettes; when you are ready to do the next
  655.      ROBOSAVE, format the diskette that holds the oldest generation and use
  656.      it for the new save.  Then even if your most recent backup is lost
  657.      because for some reason the diskette holding it is no longer readable
  658.      (it happens more often than you would like to think), you can go back
  659.      to the next most recent backup on a separate diskette.
  660.  
  661.      On the other hand, saving to a diskette is much slower than saving to
  662.      a hard drive.  Also, if the amount of data to be saved is large, you
  663.      may exceed a single diskette's capacity; ROBOSAVE does not support
  664.      diskette spanning.  For a typical system the diskette space constraint
  665.      will not be a problem, particularly if you dedicate each diskette to a
  666.      single generation of saved data.  Normally the amount of data that
  667.      should be saved is well under a megabyte.  However, you might have a
  668.      special case and have a large amount of data to save.
  669.  
  670.      A good technique is to combine the two media approaches by making fre-
  671.      quent (quick) saves to a hard drive, but making occasional saves to
  672.      the next available diskette, e.g., after you have made some partic-
  673.      ularly important change to your system.  Also, if your saved data is
  674.      too large for a diskette, you can save it to a hard drive and then
  675.      later use a data compression program, such as PKZIP, to produce a file
  676.      small enough to store offline on a diskette.  Note there was a problem
  677.      in OS/2 2.0 in which the OS2.INI and OS2SYS.INI files tended to grow
  678.      very large; that problem seems to have been much alleviated in OS/2
  679.      2.1.
  680.  
  681.      Another consideration with choosing a save directory is whether to use
  682.      the root directory as the save directory, even on a dedicated
  683.      diskette.  Generally that is not a good idea since for the FAT file
  684.      system (which is the system used for diskettes) there is a limit to
  685.      how many files can be stored in the root directory.  The limit depends
  686.      on the size of the hard disk or diskette involved, but is typically
  687.      not much greater than several hundred files.  On the other hand, a
  688.      subdirectory does not have such a limit.  Thus it is a good idea to
  689.  
  690.  
  691.  
  692.                                                   ROBOSAVE User's Guide  11
  693.      9 Nov 1993  3:04  --  Employee Written Software Edition
  694.  
  695.  
  696.      specify something like "SAVE=A:\SAVEDIR" rather than "SAVE=A:\" in
  697.      your profile.
  698.  
  699.  
  700.      1.12  CONTENTS OF THE SAVE DIRECTORY
  701.  
  702.      In your ROBOSAVE profile you designate a save directory thru the
  703.      "SAVE=" verb.  When you invoke ROBOSAVE, Desktop data and the files
  704.      you specified are saved there, together with some ROBOSAVE control
  705.      information.  Here are the types of files you may see in the save
  706.      directory.  Each "n" represents a decimal digit.
  707.  
  708.        nnnnnnnn.FIL - A "robo=" file or a file from a Desktop directory
  709.        nnnnnnnn.EAS - Extended Attributes from a file or Desktop directory
  710.        ROBOREST.CMD - Restore command created by the most recent ROBOSAVE
  711.        ROBOREST.CMn - Restore command created by a previous ROBOSAVE
  712.        ROBOSVUT.EXE - Module to check the OS/2 state and erase the Desktop
  713.        ROBOSAVE.LOG - Records all ROBOSAVE activity for this save directory
  714.        ROBOSAVE.MRK - File containing last used nnnnnnnn value
  715.  
  716.      All saved files and all files holding split extended attributes are
  717.      named with a numeric filename (nnnnnnnn) when put into the save direc-
  718.      tory.  The numeric value is incremented as each file is created.  A
  719.      check is made to ensure that the next value to be used is not already
  720.      in use in this save directory; if it is in use, the value is incre-
  721.      mented until a free value is found.  Using a numeric name instead of
  722.      the real name solves several problems.  It avoids ambiguity when two
  723.      files with the same name are saved from different directories, or when
  724.      the same file is saved multiple times in multiple generations.  It
  725.      also allows files with long HPFS names to be easily saved in a FAT
  726.      save directory, e.g., on a diskette.  The original name is restored by
  727.      the ROBOREST.CMD when it is executed.  You can see the correspondence
  728.      between the nnnnnnnn names and the real names by looking at
  729.      ROBOSAVE.LOG or the appropriate ROBOREST command.
  730.  
  731.      The "SAVENUM=" verb in the ROBOSAVE profile controls how many gener-
  732.      ations of data will be kept in the save directory.  ROBOREST.CMD is
  733.      associated with the most recent ROBOSAVE.  Each ROBOREST.CMn file is a
  734.      renamed ROBOREST.CMD that is associated with a preceding generation.
  735.      When the number of generations exceeds the "SAVENUM=" value, the
  736.      oldest ROBOREST.CMn file and all the files it points to will be
  737.      deleted from the save directory.  For example, if you have SAVENUM=3,
  738.      the following ROBOREST.CMn files would be kept in the "SAVE=" direc-
  739.      tory.
  740.  
  741.                  ROBOREST.CMD --> most recent
  742.                  ROBOREST.CM1 --> 2nd most recent
  743.                  ROBOREST.CM2 --> 3rd most recent
  744.  
  745.  
  746.                                                   ROBOSAVE User's Guide  12
  747.      9 Nov 1993  3:04  --  Employee Written Software Edition
  748.  
  749.  
  750.      If you run ROBOSAVE again, ROBOREST.CM2 and all the files it points to
  751.      will be deleted.  ROBOREST.CM1 will be renamed to ROBOREST.CM2 and
  752.      ROBOREST.CMD will be renamed to ROBOREST.CM1.  A new ROBOREST.CMD will
  753.      be written containing commands to restore the data saved by the
  754.      current run.
  755.  
  756.  
  757.      1.13  ROBOSVUT UTILITY
  758.  
  759.      ROBOSVUT.EXE is a utility module which is used by both ROBOSAVE.CMD
  760.      and ROBOREST.CMD.  It accesses some low-level OS/2 services that are
  761.      not directly available thru OS/2 commands or REXX functions.
  762.  
  763.      ROBOSAVE.CMD uses ROBOSVUT to copy files which for some reason cannot
  764.      be copied by the OS/2 COPY command.  For example, this can happen if a
  765.      file has already been opened by some other process at the time
  766.      ROBOSAVE tries to COPY it.  In that case you will see a message from
  767.      ROBOSAVE.CMD that the COPY failed and that now ROBOSVUT will be tried.
  768.      ROBOSVUT will usually succeed in this situation.  ROBOSAVE.CMD will
  769.      also use ROBOSVUT to copy files that have been marked with the Hidden
  770.      or System attribute; OS/2 COPY cannot find such files.  A consider-
  771.      ation with using ROBOSVUT to copy a file is that it will not save the
  772.      file's extended attributes.  For the files ROBOSVUT is typically used
  773.      to save, that is not important because they do not have extended
  774.      attributes.
  775.  
  776.      ROBOREST.CMD uses ROBOSVUT to verify the OS/2 environment before pro-
  777.      ceeding.  ROBOSVUT will check that the right level of OS/2 has been
  778.      IPLed to do the ROBOREST; it must be the level that was used to do the
  779.      ROBOSAVE.  This check will detect most errors, but it will not detect
  780.      if there is a CSD mismatch.  ROBOSVUT will also verify that the OS/2
  781.      Workplace Shell is not active for the Desktop being restored; if it
  782.      were active, the restore would very likely be unsuccessful, or at
  783.      least the results would be unpredictable.  (Note that the Workplace
  784.      Shell CAN be active for a different Desktop; thus it is valid to IPL
  785.      from a different partition with its own Desktop to do the ROBOREST of
  786.      the inactive partition you want to recover.)  Finally, if all the
  787.      tests are passed, the user will be prompted for authorization to erase
  788.      the Desktop to prepare a clean slate for the restoration of the saved
  789.      Desktop.  If the user answers "YES", ROBOSVUT will erase the Desktop
  790.      directory tree and then return to ROBOREST, which will then do the
  791.      actual restore.
  792.  
  793.      Here are the return codes from ROBOSVUT.EXE.  If an OS/2 function
  794.      returns an error code to ROBOSVUT, both the OS/2 function name and the
  795.      returned error code are displayed in addition to ROBOSVUT's own return
  796.      code from the following list.
  797.  
  798.  
  799.  
  800.                                                   ROBOSAVE User's Guide  13
  801.      9 Nov 1993  3:04  --  Employee Written Software Edition
  802.  
  803.  
  804.          1 - Error.  Opening source file for reading.
  805.          2 - Error.  Opening target file for writing.
  806.          6 - Error.  Unable to clear attributes on target.
  807.         11 - Error.  DosAllocMem failed.
  808.         12 - Error.  DosQuery failed for source.
  809.         13 - Error.  DosQuery failed for target.
  810.         14 - Error.  Open (READONLY) failed for target.
  811.         15 - Error.  Read failed for source.
  812.         16 - Error.  Write failed for target.  Target disk full?
  813.         17 - Error.  Close failed for target.
  814.         20 - Error.  Unable to update attributes/timestamp for target.
  815.         21 - Error.  VERIFY_COPY failed.
  816.        100 - Copy was successful.
  817.        199 - Desktop deleted successfully for ERASE_DESKTOP.
  818.        200 - User answered "NO" to prompt for ERASE_DESKTOP.
  819.        201 - Error.  DosFindFirst failed for directory.
  820.        202 - Error.  DosFindFirst found other than "." entry.
  821.        203 - Error.  DosDelete failed.
  822.        204 - Error.  DosFindNext failed.
  823.        205 - Error.  DosFindClose failed.
  824.        206 - Error.  DosDeleteDir failed.
  825.        207 - Error.  Maximum number of DosFindFirst/DosFindNexts exceeded.
  826.        251 - Error.  DosQuerySysInfo failed.
  827.        252 - Error.  DosOpen failed for test file.
  828.        253 - Error.  DosClose failed for test file.
  829.        254 - Error.  DosSetCurrentDir failed.
  830.        300 - Error.  DosOpen of test file detected Workplace Shell open.
  831.        301 - Error.  OS/2 version mismatch between ROBOSAVE and ROBOREST.
  832.  
  833.        Note:  If Ctrl-Break is pressed while ROBOSVUT is working or if the user
  834.               selects "End the program" for an OS/2 disk error prompt, a 99
  835.               can be returned by the system to the invoker of ROBOSVUT.
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                                   ROBOSAVE User's Guide  14
  855. @@@@@@